home *** CD-ROM | disk | FTP | other *** search
/ The Pier Shareware 3 / The Pier Shareware Number 3 (The Pier Exchange) (1993).iso / cdda.doc next >
Text File  |  1993-08-23  |  11KB  |  252 lines
  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║                                                                             ║
  3. ║                 Corporate Headquarters BBS (815) 886-3233                   ║
  4. ║                                            (815) 886-9381                   ║
  5. ║                                                                             ║
  6. ║                           CD-ROM DUPLICATE ANALYZER                         ║
  7. ║                                    v1.3                                     ║
  8. ║                                                                             ║
  9. ║                                                                             ║
  10. ║                               Copyright 1993                                ║
  11. ║                               by Robert Neal                                ║
  12. ║                             317 Hickory Avenue                              ║
  13. ║                            Romeoville, IL  60441                            ║
  14. ║                                                                             ║
  15. ╚═════════════════════════════════════════════════════════════════════════════╝
  16.  
  17. DISCLAIMER
  18.  
  19. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  20. CHARGE AND WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  21. LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  22. PARTICULAR PURPOSE.  IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND
  23. PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL
  24. DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  25.  
  26.  
  27.  
  28. PROGRAM DESCRIPTION
  29.  
  30. It used to be simple, a new CD ROM Shareware disc would be released
  31. about every 4-6 months. Now though, we have several key players in the
  32. market, all releasing discs that overlap files with one another. Before
  33. plunking down your cash, you ask "what's the duplication rate with brand
  34. x disc".
  35.  
  36. I originally wrote CD-ROM Duplicate Analyzer for my own personal use.
  37. I had an interest in just what the number of duplicate files between two
  38. CD's were, after all, no sense in purchasing a disc that duplicates what
  39. I already have available.  The program was crude, but it did what I
  40. wanted, quickly and easily. I, in turn, posted my "findings" in the
  41. CD-ROM conference on RIME (a national message network). Surprisingly, I
  42. had people asking where they could get the utility that I used to create
  43. the analysis. I even had several CD ROM distributors contact me directly
  44. asking if I could make the program available to them.
  45.  
  46. With all this positive feedback and encouragement on an unreleased
  47. program, I decided to put some time behind the keyboard to polish up my
  48. code for public release. The time spent polishing and enhancing the code
  49. has taken more time than the original crude version. The end result is a
  50. program that I still think is easy to use and retains it's speed. The
  51. response to this initial shareware offering will serve as encouragement
  52. to continue to release future enhanced versions as well as releasing
  53. additional utilities.
  54.  
  55.  
  56.  
  57. WHAT THE PROGRAM DOES
  58.  
  59. Quite simply, CDDA reads two file listings. The only requirement of the
  60. file listing is that the filename, with extension, be the first field in
  61. each line. Most "allfiles" listings are in this format. There is no need
  62. to strip out any information from the file listing, headers, comments,
  63. additional file comment lines will all be ignored.
  64.  
  65. If you only have a listing of individual DIRxx files, typically for
  66. PCBoard systems, these can be quickly combined into one file listing for
  67. processing by CDDA by using the batch file, CDCLIST.BAT, included with
  68. this program. For other formats, you can create an "allfiles" listing
  69. using utility programs specific for your BBS file formats. The batch
  70. file simply performs a recurrsive loop and using the DOS copy function,
  71. copies each DIRxx file out to a filename CDDA.LST. This filename can be
  72. renamed by you.
  73.  
  74. After reading a file listing, CDDA will perform an internal sort on the
  75. filenames. The sort routine is quite fast. In my tests on a 386/25
  76. system, 5,000 filenames are able to be sorted in about 15 seconds.
  77.  
  78. Once the filenames are sorted, a temporary file is created. CDDA will
  79. then compare, on a like filename basis, filenames in both listings. To
  80. be considered a "duplicate", the filenames must be exactly the same. One
  81. benefit with CDDA is that it ignores the file extension, so if a file is
  82. CD1 is listed as TESTPROG.EXE and listed in CD2 as TESTPROG.ZIP, CDDA
  83. will mark these two as duplicates.
  84.  
  85. In addition to comparing duplicates between each other, CDDA will also
  86. review the individual file listings for duplicates within themself at
  87. the same time.
  88.  
  89. CDDA also can compare file sizes to determine if files are duplicates by
  90. using the /VAR: command explained below.
  91.  
  92. Currently, CDDA does no further evaluation to verify if a indeed a
  93. duplicate. CDDA will log all found duplicates which you may then review
  94. manually if required.
  95.  
  96.  
  97. PROGRAM OPERATION
  98.  
  99. Type CDDA at the command line. You will then be prompted for the
  100. following information:
  101.  
  102. Disc Name #1 - used as a reference in the report output, enter whatever
  103.                 is useful for you
  104. File Listing Name #1 - The name of your "allfiles" file list for disc #1
  105. Disc Name #2 - Again, used only for your reference
  106. File Listing Name #2 - The other "allfiles" listing to be compared with
  107. Report Name - Name of the output report you wish to be created, may
  108.                 enter LPT1 to send to printer
  109.  
  110. After you have the above information, simply press F10 and you'll be on
  111. your way. You may press ESC during the file listing read routine to
  112. abort the process if necessary. If you leave Disc Name #1 blank the
  113. program will also terminate. The program will now begin reading and
  114. processing the data, quickly and easily.
  115.  
  116. That's all there is to it.
  117.  
  118. Here's a sample of the report output:
  119.  
  120. --------------------------------------------------------------------------
  121.  
  122. Analysis: 05-22-1993 20:22:28
  123. CD1: NIGHT OWL 8
  124. CD2: PIER 2
  125.  
  126. 93_WPCAL       Duplicate file               
  127.  
  128. [..text deleted to save space..]
  129.  
  130. XWING          Duplicate file               
  131. _1WOLF14       Duplicate file               
  132. _FDB402C       Duplicate file               
  133.  
  134. Total Files NIGHT OWL 8:  4945
  135. Total Files PIER 2:  4740 
  136. Shared Duplicates:  42  ( .86%)
  137. Dupes within NIGHT OWL 8:  12 ( .24%)
  138. Dupes within PIER 2:  0 ( 0%)
  139.  
  140. ------------------------------------------------------------------------
  141.  
  142. OPTIONAL COMMANDS
  143.  
  144. You can include the following variables on the command line when running
  145. the program, ie CDDA /REC:x /VAR:x. These commands do not need to be
  146. entered as CDDA will default the values shown below.
  147.  
  148. /REC:  (default=12,500)
  149.        Indicates the maximum number of filenames contained in a file
  150.        listing. This is used to allocate space to handle the internal
  151.        sort routine. The default is 12,500 and should be ample for most
  152.        needs. This has been tested up to 20,000 records which should
  153.        accomodate every need. Users who are limited on memory may need
  154.        to reduce this value (especially if the number of files is
  155.        significantly less than 12,500) to conserve memory space.
  156.  
  157. /VAR:  (default=100)
  158.        Indicates the file size variable that you would like to use for a
  159.        "duplicate". For example, if you entered /VAR:100, this would
  160.        instruct the program that the file size would have to be a
  161.        perfect match (in "K" as 241,000 and 241,724 would still be
  162.        considered a match). The default value is 0%, meaning the file
  163.        size can be any variance and still be considered a match (for
  164.        example, if a filename of two files were the same and one was
  165.        1,000 bytes and another was 200,000 bytes, CDDA would consider
  166.        these to be a duplicate. You can set to any value between 0% and
  167.        100%.
  168.  
  169.  
  170. CD-ROM DUPLICATE ANALYZER is released as SHAREWARE. You are granted a
  171. limited license to evaluate the program. Try it out, if you continue to
  172. use it you are required to register the program. Your registration will
  173. serve as encouragement for me to continue to release updates and
  174. additional programs.
  175.  
  176. You will notice that I have NOT crippled the program in anyway. There is
  177. a pause at the start up of the program to remind people that the program
  178. is not registered. The registrations thus far have been few, yet I know
  179. that there are CD vendors using this program. Isn't it amazing that the
  180. vendors expect to be paid for selling a shareware disc, but they don't
  181. support a program that they use. I debated on whether to restrict the
  182. unregistered program in some form and decided to just go on the trust of
  183. users who may use the program. I know I won't get rich, but if you can
  184. use this prorgam to sell your product or make an informed buying
  185. decision, you are expected to purchase the right to use this program.
  186. Off the soap box, here's the registration fees:
  187.  
  188.  
  189. PERSONAL USE
  190. ------------
  191.         To register the program send $10.00 along with your name and
  192.         address to: Robert Neal, 317 Hickory Avenue, Romeoville, IL
  193.         60441.
  194.  
  195.         Special offer - register CDDA along with another program of
  196.         mine, CD-ROM File Date Analyzer for only $5.00 more.
  197.  
  198.  
  199.  
  200. COMMERCIAL USE
  201. --------------
  202.         To register the program for commercial use, send $20.00 along
  203.         with your business name and address to the address above.
  204.  
  205.         Special offer for commercial users - register CDDA, and you can
  206.         also register another program of mine, CD-ROM File Date Analyzer
  207.         for only $10.00 more.
  208.  
  209.         CD vendors/distributors may send a copy of your CD disc in lieu
  210.         of payment and receive registration numbers for both programs. I
  211.         enjoy reviewing new discs and post my reviews on the RIME
  212.         message network, a large international message network with
  213.         nearly 1,000 different BBS's participating. The review can reach
  214.         a large potential group of consumers, eager to purchase your
  215.         product. Any CD's received will be reviewed on an impartial
  216.         basis. If you feel your CD is of quality, here's your chance to
  217.         get some free "promotion" for your product and a free copy of
  218.         BOTH programs to boot!
  219.  
  220.  
  221. CONTACT ME FOR SUPPORT
  222.  
  223. If you encounter any problems you may contact me at Corporate Headquarters
  224. BBS (815) 886-3233 or (815) 886-9381.
  225.  
  226. If you have any suggestions for improvements for this program, please feel
  227. free to let me know.
  228.  
  229. You can now register online with Visa or MasterCard. Call the support
  230. BBS listed above and type CHARGE at the main menu prompt.
  231.  
  232.  
  233.  
  234. VERSION HISTORY
  235.  
  236. v1.0 - Initial release
  237.  
  238. v1.1 - Not released
  239.  
  240. v1.2 - Not released
  241.  
  242. v1.3 - Added .JPG, BMP, PCX, MPG, TGA, TGZ and PCX to the valid file
  243.        extension search.
  244.  
  245.        Added routine to verify duplicate file by comparing filesizes,
  246.        added the /VAR: command for this.
  247.  
  248.        Greatly expanded the size of the filenames that could be sorted
  249.        from 7,500 to over 20,000 records. The default is set to 12,500
  250.        which should be more than ample, but this can be changed using
  251.        the /REC: option.
  252.